Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu
Docs Home
/ /
Instalar
Docs Home
/
Herramientas
/
Interfaz SQL
/
Instalar
Docs Home
/
Herramientas
/
Interfaz SQL
/
Instalar

Conecte su herramienta SQL a MongoDB

Conecta tu herramienta SQL, como Tableau, Power BI o DBeaver, a tu base de datos MongoDB Atlas o Enterprise Advanced (EA).

Las tres opciones de implementación de SQL Interface utilizan los mismos driver JDBC y ODBC, por lo que los pasos de esta página son los mismos tanto si se conecta a un clúster dedicado de Atlas, a una instancia federada de base de datos de Atlas o a una implementación autogestionada de Enterprise Advanced (EA). Configure su implementación para aceptar conexiones SQL primero. Para aprender cómo, consulte Configurar del servidor de interfaz SQL.

Nota

MongoDB admite oficialmente Tableau (Desktop, servidor o nube) y Power BI Desktop (Desktop y Service) con sus driver JDBC y ODBC. Puede utilizar el driver JDBC y ODBC con otras herramientas compatibles con SQL-92, pero MongoDB no puede ofrecer garantías de compatibilidad. Pruebe las funcionalidades específicas de su interfaz SQL para confirmar la compatibilidad.

Conectar Tableau

Conecte un clúster dedicado de Atlas, una instancia federada de base de datos de Atlas o una base de datos Enterprise Advanced (EA) autohospedada a Tableau (Desktop o servidor) usando el Connector de Tableau para MongoDB.

Requisitos previos

Procedimiento

Los siguientes pasos muestran cómo conectarse a MongoDB con Tableau:

1

Descarga el Connector Tableau para MongoDB.

Nota

Tableau Desktop y Tableau Server versión 2025 y posteriores incluyen el Tableau Connector para MongoDB. Si su versión de Tableau ya incluye el conector, omita este paso. Para usar una versión diferente a la que se incluye con Tableau, complete este paso.

Para Tableau Desktop, también puede instalar el conector desde Tableau. Busque MongoDB SQL interface by MongoDB en Tableau Exchange y, a continuación, haga clic en Install and restart Tableau.

  1. Descarga el archivo taco más reciente del Connector de Tableau desde el centro de descargas de MongoDB.

  2. Mueve el archivo taco al directorio apropiado para tu sistema operativo:

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • MacOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

Importante

Si descarga una nueva versión del Tableau Connector para MongoDB, borre el archivo anterior taco de su directorio Connectors para asegurar que Tableau utilice la última versión.

2

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción Tableau Connector en el menú desplegable Select your driver.

  5. Selecciona Tableau del menú desplegable.

  6. Selecciona la base de datos a la que deseas conectarte desde la lista desplegable Database.

  7. Copia tu cadena de conexión y los parámetros de conexión.

    Utiliza esta información para conectarte con Tableau en un paso posterior.

3

Abra Tableau Desktop o Tableau Server.

4

Vaya al menú Connect.

5

Seleccione MongoDB SQL Interface by MongoDB.

Se muestra un modal de conexión.

6

Ingresa la información de conexión a tu base de datos:

Introduce tu cadena de conexión de Interfaz SQL que guardaste en un paso anterior.

7

Selecciona tu método de autenticación.

Elije tu Authentication Mechanism en el desplegable.

Para obtener información sobre todos los mecanismos de autenticación compatibles, consulta Autenticación de la Interfaz SQL.

  • UsernameIngresa tu nombre de usuario de MongoDB.

  • Password: Ingresa tu contraseña de MongoDB.

8

Haga clic en Sign In.

Configurar el registro de Tableau

Para cambiar la configuración de registro para el driver JDBC de MongoDB , agregue propiedades de registro al archivo mongodb_jdbc.properties. La ubicación de este archivo depende de su plataforma:

Plataforma
ruta

macOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau servidor (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

Copie este archivo a todos los nodos del servidor.

Para configurar el registro, añada las siguientes propiedades al archivo:

loglevel=INFO
logdir=<path-to-log-directory>

La propiedad loglevel establece el nivel de verbosidad del registro del driver. Acepta los siguientes valores, en orden de nivel de verbosidad creciente: OFF, SEVERE, WARNING, INFO, FINE y FINER. El valor es por defecto OFF.

La propiedad logdir establece el directorio donde el driver guarda las entradas de registro. El directorio debe existir previamente. Si omite logdir o lo establece en console, el driver guarda los registros en la consola en lugar de en un archivo.

Importante

En entornos de producción, comience con el nivel de registro SEVERE. Suba el nivel solo cuando deba diagnosticar un problema, porque cada nivel añade una gran cantidad de salida. En el nivel FINER, el driver registro cada llamar que recupera datos para cada celda de cada conjunto de resultados.

Para obtener más información sobre los archivos de propiedades en Tableau, consulta la documentación de Tableau.

Conectar Power BI

Conecte un clúster dedicado de Atlas, una instancia federada de base de datos de Atlas o una base de datos Enterprise Advanced (EA) autohospedada a Power BI usando el BI Connector para MongoDB de Power BI.

Requisitos previos

Procedimiento

Los siguientes pasos muestran cómo conectarse a MongoDB con Power BI:

1

Descarga el Power BI Connector para MongoDB.

  1. Descargue el último archivo de Power BI Connector pqx desde el centro de descargas de MongoDB.

    Nota

    El BI Connector para MongoDB se entrega con Power BI Desktop. Si la versión de Power BI Desktop que tienes ya cuenta con el conector SQL de MongoDB Atlas, omite este paso. Para usar una versión diferente de la que viene incluida con Power BI Desktop, completa este paso.

  2. Mueve el archivo del conector a la siguiente ruta de directorio:

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    Crea esta carpeta si aún no existe.

2

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en el botón Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción Power BI Connector en el menú desplegable Select your driver.

  5. Copie su cadena de conexión.

    Utilice esta información para conectarse con Power BI en un paso posterior.

3

Conectar desde Power BI Desktop.

  1. Abre Power BI Desktop.

  2. Selecciona Get data en el menú Home.

  3. Busque y seleccione el conector MongoDB Atlas SQL.

    1. Escribe mongo en la barra de búsqueda para encontrar el nuevo conector.

    2. Seleccione MongoDB Atlas SQL.

    3. Haga clic en Connect.

  4. Introduce la URI y el nombre de la base de datos, y haz clic en OK.

    El MongoDB URI es la cadena de conexión que copiaste en un paso anterior.

    En el campo Native query, puede introducir opcionalmente una query SQL. Power BI utiliza la query SQL como fuente directa de los datos. También puede agregar o cambiar la query SQL en el editor de Power Query después de conectarse.

  5. Introduzca su Atlas User name y Password y haga clic en Connect.

    Por defecto, los usuarios pueden acceder a todos los namespace que sus roles y URI de conexión permitan. Si utiliza roles personalizados para restringir el acceso, puede conceder a los usuarios acceso a namespaces adicionales en el menú Edit User. Para obtener más información, consulta Configurar los usuarios de base de datos.

    Para obtener información sobre otros mecanismos de autenticación compatibles, consulta Autenticación de Interfaz SQL.

query directo

query directo es una moda de conexión disponible con el Power BI Connector para MongoDB versión 1.2 y posteriores. Para usar el query directo, debe instalar el driver ODBC de MongoDB versión 1.2 o posterior. No es necesario configurar un DSN.

El query directo es una alternativa a la moda de importación estándar y le permite consultar su base de datos directamente. Esto garantiza datos actualizados, pero puede tardar más en devolver resultados.

Query directo no admite algunas acciones. Si se intenta realizar una acción no compatible, Power BI pide que se cambie a Import Moda.

Conectar DBeaver

Conecte su clúster dedicado de Atlas, su instancia de base de datos federada de Atlas o su implementación autogestionada de Enterprise Advanced (EA) a DBeaver mediante el controlador JDBC de MongoDB.

Requisitos previos

Procedimiento

Para conectarse desde DBeaver:

1

Obtenga la información de conexión de la base de datos MongoDB.

Seleccione la pestaña para su tipo de implementación para obtener instrucciones sobre cómo obtener su información de conexión:

  1. Ve a tu clúster dedicado de Atlas o a la instancia federada de base de datos de Atlas para tu proyecto.

  2. Haga clic en el botón Connect.

  3. Seleccione la opción Atlas SQL Interface.

  4. Selecciona la opción JDBC Driver en el menú desplegable Select your driver.

  5. Selecciona la base de datos a la que deseas conectarte desde la lista desplegable Database.

  6. Copie su cadena de conexión.

    Utilice esta información para conectarse con DBeaver en un paso posterior.

2

Abra su DBeaver aplicación.

3

Agrega un controlador a DBeaver.

  1. En DBeaver, haz clic en Database y selecciona Driver Manager en el menú desplegable.

  2. Haz clic en New para abrir el modal Create new driver.

  3. En la pestaña Settings, especifique la siguiente información:

    Driver Name

    MongoSQL

    Nombre de la clase

    com.mongodb.jdbc.MongoDriver

  4. En la pestaña Libraries, haz clic en Add File y añade tu archivo de controlador JDBC all.jar.

    Haga clic en Find Class.

  5. Haz clic en OK. Se cierra el modal de Create new driver.

4

Crea una conexión de base de datos.

  1. En DBeaver, haz clic en Database y selecciona New Database Connection del menú desplegable para abrir el modal Connect to a database.

  2. De la lista de bases de datos, selecciona el controlador de base de datos MongoDB que creaste en el paso anterior.

    Si no ves MongoDB, selecciona la categoría All dentro del modal.

    Haga clic en Next.

  3. En la pestaña Main, ingrese la siguiente información:

    JDBC URL

    Cadena de conexión obtenida de un paso anterior.

    Nombre de usuario

    Usuario de MongoDB autorizado para la conexión.

    Contraseña

    Contraseña asociada con el usuario de MongoDB.

  4. En la pestaña Driver properties, expanda User Properties. Agregar las siguientes propiedades clave-valor:

    database

    El nombre de tu base de datos virtual.

    usuario

    El usuario de MongoDB con el que se conecta. No se requiere si ingresó un Username en el paso anterior.

Próximos pasos

Después de que conectes tu herramienta SQL a tu base de datos MongoDB, puedes query tus datos. Para aprender más, consulta:

Nota

Para conectarse utilizando nodos privados, consulte Conéctese a la interfaz SQL de MongoDB con nodos privados.

Volver
Configuración del controlador
Next
Query
Califique esta página

En esta página